Select Multiple Items
AutomatR.Web.SelectMultipleItems
The "Select Multiple Items" activity in AutomatR is designed for UI automation workflows, specifically for selecting multiple items from a combo box or list box within a web application. This activity streamlines the process of interacting with dropdowns and lists, allowing the selection of multiple items simultaneously.
Properties
| Name | Description |
|---|---|
| Input | |
| Element | Select the web element by using the provided selector window. This indicates the UI element on the web page. Use either the "Element" or "WebElement" property. |
| WebElement | Enter the UI element variable identified by the "Find Element" or other activities. Use either the "Element" or "WebElement" property. |
| Item Names | Enter a list of strings representing the names of the items to be selected from the dropdown or list box. Provide either the "Item Names" or "Item Values" property; not both. |
| Item Values | Enter a list of strings representing the item values, which can be captured from the CSS/DOM of the dropdown or list box. Provide either the "Item Names" or "Item Values" property; not both. |
| Misc | |
| Display Name | Provides a customizable name for the activity displayed in the workflow. String variables containing the desired display name. |
| Optional | |
| Timeout | Enter the time, in seconds (e.g., 5), for the activity to be executed before throwing an exception. This is the maximum time the activity will wait for the selection to occur. If not provided, a default timeout will be used. |
| Delay | Enter the wait time in seconds before starting the activity. This can be useful for handling synchronization issues or waiting for specific conditions before selecting multiple items. |
| Output | |
| Result | Returns True or False based on the success of the multiple item selection. Use this output to verify if the items were successfully selected. |
How to use:
- Drag and drop the "Select Multiple Items" activity onto the workflow.
- Configure the properties by selecting the web element or providing the UI element variable.
- Specify either the "Item Names" or "Item Values" for the items you want to select from the dropdown or list box.
- Optionally, configure the timeout and delay.
- Execute the workflow to interact with the specified dropdown or list box and select the desired multiple items.
Example: Consider an example where the "Select Multiple Items" activity is used to choose multiple items from a list:
Select Multiple Items:
Element: (Use the selector window to choose the dropdown element)
Item Names: ["Item1", "Item2", "Item3"]
Timeout: 10 (seconds)
Result: areItemsSelected
In this example, the activity selects the items with names "Item1", "Item2", and "Item3" from the specified dropdown element. The timeout is set to 10 seconds, and the result is stored in the Boolean variable "areItemsSelected" for further workflow logic.